home *** CD-ROM | disk | FTP | other *** search
/ Aminet 52 / Aminet 52 (2002)(GTI - Schatztruhe)[!][Dec 2002].iso / Aminet / dev / gg / ncurses-5.3.lha / ncurses-5.3 / ANNOUNCE < prev    next >
Text File  |  2002-10-24  |  19KB  |  392 lines
  1.  
  2.                             Announcing ncurses 5.3
  3.  
  4.    The  ncurses  (new  curses)  library  is  a free software emulation of
  5.    curses  in  System  V  Release 4.0, and more. It uses terminfo format,
  6.    supports  pads  and color and multiple highlights and forms characters
  7.    and   function-key   mapping,   and  has  all  the  other  SYSV-curses
  8.    enhancements over BSD curses.
  9.  
  10.    In  mid-June  1995,  the  maintainer of 4.4BSD curses declared that he
  11.    considered  4.4BSD  curses obsolete, and is encouraging the keepers of
  12.    Unix  releases  such  as  BSD/OS, freeBSD and netBSD to switch over to
  13.    ncurses.
  14.  
  15.    The ncurses code was developed under GNU/Linux. It has been in use for
  16.    some  time  with  OpenBSD as the system curses library, and on FreeBSD
  17.    and  NetBSD  as  an  external  package.  It  should port easily to any
  18.    ANSI/POSIX-conforming UNIX. It has even been ported to OS/2 Warp!
  19.  
  20.    The distribution includes the library and support utilities, including
  21.    a   terminfo  compiler  tic(1),  a  decompiler  infocmp(1),  clear(1),
  22.    tput(1),  tset(1),  and  a  termcap conversion tool captoinfo(1). Full
  23.    manual pages are provided for the library and tools.
  24.  
  25.    The  ncurses  distribution  is  available via anonymous FTP at the GNU
  26.    distribution site [1]ftp://ftp.gnu.org/pub/gnu/ncurses.
  27.    It is also available at [2]ftp://invisible-island.net/ncurses.
  28.  
  29.                                  Release Notes
  30.  
  31.    This  release is designed to be upward compatible from ncurses 5.0 and
  32.    5.2;  very  few  applications will require recompilation, depending on
  33.    the  platform.  These  are  the  highlights  from the change-log since
  34.    ncurses 5.2 release.
  35.  
  36.    Interface changes:
  37.      * change  type  for  bool  used  in  headers  to NCURSES_BOOL, which
  38.        usually is the same as the compiler's definition for bool.
  39.      * add  all  but  two  functions  for  X/Open  curses  wide-character
  40.        support.  These  are  only  available if the library is configured
  41.        using the --enable-widec option. Missing functions are
  42.           + pecho_wchar()
  43.           + slk_wset()
  44.      * add  environment  variable  $NCURSES_ASSUMED_COLORS  to modify the
  45.        assume_default_colors() extension.
  46.  
  47.    New features and improvements:
  48.      * Improved support for termcap applications:
  49.           + add  logic to dump_entry.c to remove function-key definitions
  50.             that  do  not  fit  into  the  1023-byte  limit for generated
  51.             termcaps. This makes hds200 fit.
  52.           + modify  tgetent()  to check if exit_attribute_mode resets the
  53.             alternate  character  set,  and  if so, attempt to adjust the
  54.             copy  of  the  termcap  "me"  string  which it will return to
  55.             eliminate that part. In particular, 'screen' would lose track
  56.             of line-drawing characters.
  57.           + add  check/fix  to  comp_parse.c  to  suppress  warning about
  58.             missing acsc string. This happens in configurations where raw
  59.             termcap  information  is processed; tic already does this and
  60.             other checks.
  61.           + add   tic  -A  option  to  suppress  capabilities  which  are
  62.             commented out when translating to termcap.
  63.           + modify  logic  in  lib_baudrate.c  for ospeed, for FreeBSD to
  64.             make  it  work  properly  for  termcap applications (patch by
  65.             Andrey A Chernov).
  66.      * add a call to _nc_keypad() in keypad() to accommodate applications
  67.        such  as nvi, which use curses for output but not for input (fixes
  68.        Debian #131263, cf: 20011215).
  69.      * correct  logic  for  COLORFGBG  environment  variable:  if rxvt is
  70.        compiled  with  xpm support, the variable has three fields, making
  71.        it   slightly  incompatible  with  itself.  In  either  case,  the
  72.        background color is the last field.
  73.  
  74.    Major bug fixes:
  75.      * rewrote     limit-checks     in     wscrl()     and     associated
  76.        _nc_scroll_window(), to ensure that if the parameter of wscrl() is
  77.        larger  than  the size of the scrolling region, then the scrolling
  78.        region will be cleared.
  79.      * modify  tset  to  restore  original  I/O  modes  if  an  error  is
  80.        encountered.  Also  modify  to  use  buffered  stderr consistently
  81.        rather than mixing with write().
  82.      * move  calls  to  def_shell_mode()  and def_prog_mode() before loop
  83.        with  callbacks  in  lib_set_term.c,  since the c++ demo otherwise
  84.        initialized the tty modes before saving them.
  85.      * modified  wresize()  to  ensure  that  a  failed  realloc will not
  86.        corrupt  the  window  structure, and to make subwindows fit within
  87.        the resized window.
  88.      * altered  resizeterm()  to avoid having it fail when a child window
  89.        cannot be resized because it would be larger than its parent.
  90.      * correct/improve  logic  to  produce  an  exit status for errors in
  91.        tput,  which  did not exit with an error when told to put a string
  92.        not in the current terminfo entry.
  93.      * modify  behavior  of can_clear_with() so that if an application is
  94.        running  in  a  non-bce  terminals with default colors enabled, it
  95.        returns  true,  allowing  the  user  to  select/paste text without
  96.        picking up extraneous trailing blanks.
  97.      * add a check in relative_move() to guard against buffer overflow in
  98.        the overwrite logic.
  99.      * add some limit/pointer checks to -S option of tputs.
  100.      * modify  mvcur()  to  avoid emitting newline characters when nonl()
  101.        mode  is  set.  Normally  this  is  not a problem since the actual
  102.        terminal  mode is set to suppress nl/crlf translations, however it
  103.        is  useful  to allow the caller to manipulate the terminal mode to
  104.        avoid  staircasing  effects  after spawning a process which writes
  105.        messages (for lynx 2.8.4).
  106.  
  107.    Portability:
  108.      * configure script:
  109.           + modify check in --disable-overwrite option so that it is used
  110.             by  default unless the --prefix/$prefix value is not /usr, in
  111.             attempt  to work around packagers who do not read the INSTALL
  112.             notes.
  113.           + correct  a  typo  in configure --enable-colorfgbg option, and
  114.             move it to the experimental section (cf: 20011208).
  115.           + modify  configure script to allow building with termcap only,
  116.             or with fallbacks only. In this case, we do not build tic and
  117.             toe.
  118.           + modify  run_tic.sh  to check if the build is a cross-compile.
  119.             In  that  case,  do  not  use  the build's tic to install the
  120.             terminfo database.
  121.           + modify  c++/Makefile.in  to accommodate archive programs that
  122.             are  different for C++ than for C, and add cases for vendor's
  123.             C++ compilers on Solaris and IRIX.
  124.           + add   several   configure   script   options   to   aid  with
  125.             cross-compiling:     --with-build-cc,    --with-build-cflags,
  126.             --with-build-ldflags, and --with-build-libs.
  127.           + add  experimental  --with-caps=XXX  option  to  customize  to
  128.             similar terminfo database formats such as AIX 4.x
  129.           + add  configure  option  --with-ospeed  to assist packagers in
  130.             transition to 5.3 change to ospeed type.
  131.      * library:
  132.           + implement a simple vsscanf() fallback function which uses the
  133.             %n conversion to help parse the input data.
  134.           + various fixes to build/work with different implementations of
  135.             vsscanf().
  136.           + add/use  macro  to  suppress  sign-extension  of char type on
  137.             platforms  where  this  is  a  problem in ctype macros, e.g.,
  138.             Solaris.
  139.           + finish changes needed to build dll's on cygwin.
  140.           + add  #undef's  before  possible redefinition of ERR and OK in
  141.             curses.h
  142.      * programs:
  143.           + modify  ifdef's  in  write_entry.c  to  allow use of symbolic
  144.             links on platforms with no hard links, e.g., BeOS.
  145.           + modify  _nc_write_entry()  to  allow for the possibility that
  146.             linking  aliases  on a filesystem that ignores case would not
  147.             succeed  because  the  source  and destination differ only by
  148.             case, e.g., NCR260VT300WPP0 on cygwin.
  149.           + modify  logic  in  tic,  toe,  tput and tset which checks for
  150.             basename  of argv[0] to work properly on systems such as OS/2
  151.             which   have   case-independent   filenames   and/or  program
  152.             suffixes, e.g., ".ext".
  153.  
  154.                               Features of Ncurses
  155.  
  156.    The ncurses package is fully compatible with SVr4 (System V Release 4)
  157.    curses:
  158.      * All  257  of  the  SVr4  calls  have  been  implemented  (and  are
  159.        documented).
  160.      * Full  support for SVr4 curses features including keyboard mapping,
  161.        color,   forms-drawing   with   ACS   characters,   and  automatic
  162.        recognition of keypad and function keys.
  163.      * An  emulation  of  the  SVr4 panels library, supporting a stack of
  164.        windows with backing store, is included.
  165.      * An  emulation  of the SVr4 menus library, supporting a uniform but
  166.        flexible interface for menu programming, is included.
  167.      * An  emulation of the SVr4 form library, supporting data collection
  168.        through on-screen forms, is included.
  169.      * Binary   terminfo   entries   generated   by  the  ncurses  tic(1)
  170.        implementation  are  bit-for-bit-compatible  with the entry format
  171.        SVr4 curses uses.
  172.      * The utilities have options to allow you to filter terminfo entries
  173.        for  use  with  less  capable curses/terminfo versions such as the
  174.        HP/UX and AIX ports.
  175.  
  176.    The ncurses package also has many useful extensions over SVr4:
  177.      * The  API  is 8-bit clean and base-level conformant with the X/OPEN
  178.        curses  specification, XSI curses (that is, it implements all BASE
  179.        level   features,   but   not   all   EXTENDED   features).   Most
  180.        EXTENDED-level features not directly concerned with wide-character
  181.        support   are  implemented,  including  many  function  calls  not
  182.        supported  under  SVr4  curses  (but  portability  of all calls is
  183.        documented so you can use the SVr4 subset only).
  184.      * Unlike  SVr3 curses, ncurses can write to the rightmost-bottommost
  185.        corner  of  the  screen  if  your terminal has an insert-character
  186.        capability.
  187.      * Ada95 and C++ bindings.
  188.      * Support  for  mouse  event  reporting with X Window xterm and OS/2
  189.        console windows.
  190.      * Extended mouse support via Alessandro Rubini's gpm package.
  191.      * The  function  wresize()  allows you to resize windows, preserving
  192.        their data.
  193.      * The function use_default_colors() allows you to use the terminal's
  194.        default colors for the default color pair, achieving the effect of
  195.        transparent colors.
  196.      * The functions keyok() and define_key() allow you to better control
  197.        the  use  of function keys, e.g., disabling the ncurses KEY_MOUSE,
  198.        or  by  defining  more than one control sequence to map to a given
  199.        key code.
  200.      * Support for 16-color terminals, such as aixterm and XFree86 xterm.
  201.      * Better  cursor-movement  optimization.  The package now features a
  202.        cursor-local-movement computation more efficient than either BSD's
  203.        or System V's.
  204.      * Super   hardware   scrolling   support.   The  screen-update  code
  205.        incorporates  a novel, simple, and cheap algorithm that enables it
  206.        to  make  optimal  use  of hardware scrolling, line-insertion, and
  207.        line-deletion  for  screen-line  movements. This algorithm is more
  208.        powerful than the 4.4BSD curses quickch() routine.
  209.      * Real  support  for  terminals  with  the  magic-cookie glitch. The
  210.        screen-update  code  will  refrain from drawing a highlight if the
  211.        magic-   cookie  unattributed  spaces  required  just  before  the
  212.        beginning  and  after the end would step on a non-space character.
  213.        It  will  automatically  shift  highlight boundaries when doing so
  214.        would  make it possible to draw the highlight without changing the
  215.        visual appearance of the screen.
  216.      * It  is  possible to generate the library with a list of pre-loaded
  217.        fallback  entries linked to it so that it can serve those terminal
  218.        types  even  when  no  terminfo tree or termcap file is accessible
  219.        (this  may  be useful for support of screen-oriented programs that
  220.        must run in single-user mode).
  221.      * The tic(1)/captoinfo utility provided with ncurses has the ability
  222.        to  translate many termcaps from the XENIX, IBM and AT&T extension
  223.        sets.
  224.      * A BSD-like tset(1) utility is provided.
  225.      * The ncurses library and utilities will automatically read terminfo
  226.        entries  from  $HOME/.terminfo  if  it exists, and compile to that
  227.        directory  if  it  exists  and the user has no write access to the
  228.        system  directory.  This feature makes it easier for users to have
  229.        personal  terminfo  entries without giving up access to the system
  230.        terminfo directory.
  231.      * You  may  specify  a  path  of  directories to search for compiled
  232.        descriptions  with  the  environment  variable TERMINFO_DIRS (this
  233.        generalizes  the  feature  provided by TERMINFO under stock System
  234.        V.)
  235.      * In  terminfo  source files, use capabilities may refer not just to
  236.        other entries in the same source file (as in System V) but also to
  237.        compiled  entries  in  either the system terminfo directory or the
  238.        user's $HOME/.terminfo directory.
  239.      * A  script  (capconvert)  is  provided to help BSD users transition
  240.        from  termcap to terminfo. It gathers the information in a TERMCAP
  241.        environment  variable  and/or  a ~/.termcap local entries file and
  242.        converts   it   to   an   equivalent  local  terminfo  tree  under
  243.        $HOME/.terminfo.
  244.      * Automatic  fallback  to  the  /etc/termcap file can be compiled in
  245.        when  it is not possible to build a terminfo tree. This feature is
  246.        neither  fast  nor cheap, you don't want to use it unless you have
  247.        to, but it's there.
  248.      * The  table-of-entries  utility  toe makes it easy for users to see
  249.        exactly what terminal types are available on the system.
  250.      * The library meets the XSI requirement that every macro entry point
  251.        have  a  corresponding  function  which may be linked (and will be
  252.        prototype-checked)  if  the  macro  definition  is  disabled  with
  253.        #undef.
  254.      * An  HTML  "Introduction  to  Programming  with  NCURSES"  document
  255.        provides  a  narrative  introduction  to  the  curses  programming
  256.        interface.
  257.  
  258.                              State of the Package
  259.  
  260.    Numerous bugs present in earlier versions have been fixed; the library
  261.    is  far  more  reliable  than  it  used to be. Bounds checking in many
  262.    `dangerous'  entry points has been improved. The code is now type-safe
  263.    according  to gcc -Wall. The library has been checked for malloc leaks
  264.    and arena corruption by the Purify memory-allocation tester.
  265.  
  266.    The  ncurses  code has been tested with a wide variety of applications
  267.    including (versions starting with those noted):
  268.  
  269.    cdk
  270.           Curses Development Kit
  271.           [3]http://invisible-island.net/cdk.
  272.           [4]http://www.vexus.ca/CDK.html
  273.  
  274.    ded
  275.           directory-editor
  276.           [5]http://invisible-island.net/ded.
  277.  
  278.    dialog
  279.           the  underlying  application used in Slackware's setup, and the
  280.           basis for similar applications on GNU/Linux.
  281.           [6]http://invisible-island.net/dialog.
  282.  
  283.    lynx
  284.           the character-screen WWW browser
  285.           [7]http://lynx.isc.org/release.
  286.  
  287.    Midnight Commander
  288.           file manager
  289.           [8]www.gnome.org/mc/.
  290.  
  291.    mutt
  292.           mail utility
  293.           [9]http://www.mutt.org.
  294.  
  295.    ncftp
  296.           file-transfer utility
  297.           [10]http://www.ncftp.com.
  298.  
  299.    nvi
  300.           New vi versions 1.50 are able to use ncurses versions 1.9.7 and
  301.           later.
  302.           [11]http://www.bostic.com/vi/.
  303.  
  304.    tin
  305.           newsreader, supporting color, MIME
  306.           [12]http://www.tin.org.
  307.  
  308.    taper
  309.           tape archive utility
  310.           [13]http://members.iinet.net.au/~yusuf/taper/.
  311.  
  312.    vh-1.6
  313.           Volks-Hypertext browser for the Jargon File
  314.           [14]http://www.bg.debian.org/Packages/unstable/text/vh.html.
  315.  
  316.    as well as some that use ncurses for the terminfo support alone:
  317.  
  318.    minicom
  319.           terminal emulator
  320.           [15]http://www.pp.clinet.fi/~walker/minicom.html.
  321.  
  322.    vile
  323.           vi-like-emacs
  324.           [16]http://invisible-island.net/vile.
  325.  
  326.    The  ncurses  distribution  includes  a  selection  of  test  programs
  327.    (including a few games).
  328.  
  329. Who's Who and What's What
  330.  
  331.    The original developers of ncurses are [17]Zeyd Ben-Halim and [18]Eric
  332.    S.  Raymond.  Ongoing  work  is  being  done  by [19]Thomas Dickey and
  333.    [20]Jürgen  Pfeifer.  [21]Thomas Dickey acts as the maintainer for the
  334.    Free  Software  Foundation,  which  holds  the  copyright  on ncurses.
  335.    Contact the current maintainers at [22]bug-ncurses@gnu.org.
  336.  
  337.    To   join   the   ncurses   mailing   list,   please  write  email  to
  338.    bug-ncurses-request@gnu.org containing the line:
  339.              subscribe <name>@<host.domain>
  340.  
  341.    This list is open to anyone interested in helping with the development
  342.    and testing of this package.
  343.  
  344.    Beta  versions  of ncurses and patches to the current release are made
  345.    available at [23]ftp://invisible-island.net/ncurses.
  346.  
  347. Future Plans
  348.  
  349.      * Extended-level   XPG4   conformance,   with   internationalization
  350.        support.
  351.      * Ports to more systems, including DOS and Windows.
  352.  
  353.    We  need  people to help with these projects. If you are interested in
  354.    working on them, please join the ncurses list.
  355.  
  356. Other Related Resources
  357.  
  358.    The  distribution  includes  and uses a version of the terminfo-format
  359.    terminal    description    file    maintained    by    Eric   Raymond.
  360.    [24]http://earthspace.net/~esr/terminfo.
  361.  
  362.    You  can  find  lots  of  information  on  terminal-related topics not
  363.    covered in the terminfo file at [25]Richard Shuford's archive.
  364.  
  365. References
  366.  
  367.    1. ftp://ftp.gnu.org/pub/gnu/ncurses
  368.    2. ftp://invisible-island.net/ncurses
  369.    3. http://invisible-island.net/cdk/cdk.html
  370.    4. http://www.vexus.ca/CDK.html
  371.    5. http://invisible-island.net/ded/ded.html
  372.    6. http://invisible-island.net/dialog/dialog.html
  373.    7. http://lynx.isc.org/release/
  374.    8. file://localhost/usr/build/ncurses/ncurses-5.2-20021012/doc/html/www.gnome.org/mc/
  375.    9. http://www.mutt.org/
  376.   10. http://www.ncftp.com/
  377.   11. http://www.bostic.com/vi/
  378.   12. http://www.tin.org/
  379.   13. http://members.iinet.net.au/~yusuf/taper/
  380.   14. http://www.bg.debian.org/Packages/unstable/text/vh.html
  381.   15. http://www.pp.clinet.fi/~walker/minicom.html
  382.   16. http://invisible-island.net/vile/vile.html
  383.   17. mailto:zmbenhal@netcom.com
  384.   18. http://www.ccil.org/~esr/home.html
  385.   19. mailto:dickey@herndon4.his.com
  386.   20. http://www.familiepfeifer.de/Contact.aspx?Lang=en
  387.   21. mailto:dickey@herndon4.his.com
  388.   22. mailto:bug-ncurses@gnu.org
  389.   23. ftp://invisible-island.net/ncurses
  390.   24. http://earthspace.net/~esr/terminfo
  391.   25. http://www.cs.utk.edu/~shuford/terminal_index.html
  392.